home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
PC Graphics Unleashed
/
PC Graphics Unleashed.iso
/
ch01
/
display.doc
< prev
next >
Wrap
Text File
|
1994-07-29
|
24KB
|
673 lines
DDDD III SSSS PPPP LL AAAAA YY YY
DDDDD III SSSSSS PPPPPP LL AAAAAAAAA YY YY
DD DD III SSS PP PP LL AA AA YY YY
DD DD III SSSSS PPPPPP LL AA AA YYYY
DD DD III SSSSS PPPP LL AAAAAAAAA YY
DD DD III SSS PP LL AA AA YY
DDDDD III SSSSSS PP LL AA AA YY
DDDD III SSSS PP LLLLLLLL AA AA YY
Program written by
Jih-Shin Ho (u7711501@bicmos.ee.nctu.edu.tw)
Document written by
Jih-Shin Ho (u7711501@bicmos.ee.nctu.edu.tw)
and
Oliver Weyand (chbrin3@nyx.uni-konstanz.de)
Document modified by
Ben Jos Walbeehm (Walbeehm@fsw.ruu.nl)
!!! You may distribute this program freely for non-commercial use. !!!
!!! There is no warranty. The author is not responsible for any !!!
!!! damage caused by this program. !!!
(1) Introduction:
This program lets you READ, WRITE and DISPLAY images/movies with different
formats. It lets you do some special effects (rotation, dithering, ...)
on images as well.
Features:
Includes simple file management system.
Supports 'slide show', 'batch conversion', 'contact sheet making',
'image preview'.
There is NO LIMIT on image size.
This program supports 8, 15, 16, 24 bits display.
Supports movie files (DL, FLI/FLC, RAW, MPEG, AVI, GL, IFF/ANIM).
Supports FLC making.
Supports mouse.
The official site is NCTUCCCA.edu.tw:/PC/graphics/disp.
The IP address is 140.111.1.10 or 192.83.166.10
(2) Command Line Switches:
DISPLAY understands several command-line parameters. Some of them are
useful for setting up your preferred configuration or overwriting
config.dis options. Others are for command-line processing.
Usage :
display [-d|--display initial_display_type] [-s|--sort sort_method]
[-f config_file] [-a] [-n l|g] [--help|-?]
[--direct|-t working_directory] [--mask|-m filename_mask]
[--width|-w image_width] [--height|-h image_height]
[image_file(s) | @response_file]
For command-line batch conversion :
display (--batch | -b) output_format [--bw|--grey|--color|--true]
+ [--dialog | -g] [--report|-r report_file]
(file | file dir | file_in file_out | files dir)
For command-line slide show :
display [--slide|-l] [--noask|-k] (image_files | @response_file)
+ For command-line contact sheet generation :
+ display (--sheet|-e) batch_conatc_sheet_script [--report|-r report_file]
Display type: 8 (SVGA, default), 15, 16 (HiColor), 24 (TrueColor)
Sort method: 'name', 'ext'
-a: Always set to highest display type
-f: Read user specified config file only.
-n: Do not read Local or Global config file.
-w & -h: for image format without information header(YUV,RGB,GREY).
output_format : Standard extensions. Like gif, bmp ... (see section (7))
filename mask : separated by ';'.
The default color type for batch conversion is Full color (8 bits).
Please read NEW-FAQ for the information about batch contact sheet.
(3) Function Keys:
Escape : Abort function and return.
RETURN : Select.
In menu selection :
ESCAPE,F10 : Quit program (prompted).
F1 : Show READ.ME.
CTRL-F1 : Show user-defined help file.
F9 : For those who cannot remember all commands of DISPLAY.
F2 : Change disk drive.
CTRL-A -- CTRL-Z : change disk drive.
F3 : Change filename masks. (Separated by ';') (See match.doc)
F4 : Change parameters.
F5 : Some effects on pictures, e.g. flip, rotate ...
F7 : Make Directory.
t,T : Tag file. (Untags tagged files)
+ : Tag a group of files. (See match.doc)
ALT-T : Tag all files.
u,U : Untag file.
- : Untag a group of files. (See match.doc)
ALT-U : Untag all files.
Ins : Change display type (8, 15, 16, 24 bits).
F6,m,M : Move file(s).
ALT-M : Move single file (ignores tags).
F8,d,D : Delete file(s).
ALT-D : Delete single file (ignores tags).
r,R : Rename file.
c,C : Copy File(s).
ALT-C : Copy single file (ignore tags).
z,Z : Display first 10 bytes in Ascii, Hex and Dec modes.
f,F : Display disk free space.
Page Up/Down : Move one page.
TAB : In mode selection screen : Change process target.
In file selection screen : Show previously loaded image.
w,W : Write previously loaded image.
Left/Right arrow: Change display type In 'screen' & 'effects' menu.
s,S : Slide Show (shows tagged files). ESCAPE to terminate.
b,B : Batch conversion (converts tagged files to a single format).
You can perform up to 8 special operations.
Each is independent of the others.
e,E : Contact sheet making.
w,W : Wait/Pause in slide show.
q,Q : Accumulation color quantization.
Finds the best palette set for a group of files.
Very useful for producing animation pictures.
l,L : List available graphic/text modes.
o,O : Display font.
ALT-X : Quit program without prompting.
ALT-A : Re-read directory.
ALT-S : Save config file.
0..9 :
SHIFT-A..Z : Jump to first file whose name starts with this character.
BACKSPACE : Go up one level in the directory tree.
v,V : View text file.
x,X : View binary file.
p,P : Turn preview on/off.
ALT-Z : Shell to DOS.
+ ALT-E : Edit description entry. (see NEW-FAQ)
+ ALT-W : Write description entries. (see NEW-FAQ)
In graphics mode :
RETURN,SPACE,ESCAPE : return to the text mode.
'+' : Go to next resolution.
'-' : Go to previous resolution.
Arrow keys, Home, End, Page Up, Page Down : Scroll image.
Home: Left-most.
End: Right-most.
Page Up: Top of image.
Page Down: Bottom of image.
CTRL-Arrow keys: Crop image by one line.
CTRL-SHIFT-Arrow keys: Big Crop (Controlled by 'big_crop_step').
F1 .. F8 : Gamma correction.
F1,F3,F5,F7: decrease Red,Green,Blue,All.
F2,F4,F6,F8: increase Red,Green,Blue,All.
F9,F10 : Zoom Out/In.
In text viewer :
F2 : Search string (case-sensitive).
F3 : Search string (case-insensitive).
In contact sheet preview & Postscript preview :
'+' : Increase scaling factor.
'-' : Decrease scaling factor.
Ins,Del : Fine tune(Inc/Dec) scaling factor.
In Slide show :
If the delay time is 0, the program will wait until you hit any key
(except ESCAPE).
'w' or 'W' to pause, any key to continue.
+ Up-Arrow : Go back one image.
+ Note: Reverse slide show is slower.
+ You must set delay time = 0 to use Up-Arrow.
In movie:
SPACE : pause playing. If you press 'w' or 'W', the program writes the
current frame to a file. After writing, playback pauses at the next
frame.
ESCAPE : Terminate playing.
(4) Mouse Buttons:
MIDDLE button and CTRL-RIGHT button always mean ESCAPE.
in read/write menu:
single-click LEFT or RIGHT button = 'move select bar'.
double-click LEFT button = RETURN.
double-click RIGHT button = SPACE.
CTRL-LEFT button = Tag.
in other text menus:
RIGHT button means SPACE.
single-click LEFT button = 'move select bar'.
double-click LEFT button = RETURN.
in contact sheet preview:
RIGHT = show/hide mouse cursor.
LEFT = move an image piece if the mouse cursor is shown,
else leave graphics mode.
CTRL-LEFT = move contact sheet.
in image display screen:
RIGHT = show/hide mouse cursor.
LEFT = move the image around the screen if the mouse cursor is shown,
else leave graphics mode.
CTRL-LEFT = move one page.
SHIFT-LEFT = show information box.
You can move this box around screen by click and drag.
ALT-LEFT = define rectangle for cropping.
Releasing left button will crop image if ALT key is still pressed,
else do nothing.
CTRL-ALT-LEFT = toggle showing image coordinates.
in mode selection screen:
Click LEFT bottom at:
'Imag8' or 'Imag24' : change processing target.
'000 x 000 x 000' or '000 x 000' : change display type.
'<--' or '|||' : change linking status.
In some text regions the mouse cursor will change. Press the LEFT button
to accomplish that.
(5) Supported Formats:
Read: GIF(.gif), Japan MAG(.mag), Japan PIC(.jpc), Sun Raster(.ras),
Jpeg(.jpg), XBM(.xbm), Utah RLE(.rle), PBM(.pbm), PGM(.pgm),
PPM(.ppm), PM(.pm), PCX(.pcx), Japan MKI(.mki), Tiff(.tif),
Targa(.tga), XPM(.xpm), Mac Paint(.mac), GEM/IMG(.img),
IFF/ILBM(.iff,.lbm), Windows BMP(.bmp), QRT ray tracing(.qrt),
Mac PICT(.pct), VIS(.vis), PDS(.pds), VIKING(.vik), VICAR(.vic),
FITS(.fit), Usenix FACE(.fac), IRIS(.sgi), YUV(.yuv), RAW RGB(.rgb),
PCPAINT/Pictor(.pic,.clp), RAW GREY(.gry), Photo-CD(.pcd).
DL(.dl), FLI(.fli), FLC(.flc), RAW(.raw, produced by DMPEG),
MPEG(.mpg), AVI(.avi), GL(.gl).
the extensions in () are standard extensions.
Write: GIF, Sun Raster, Jpeg, XBM, PBM, PGM, PPM, PM, Tiff, Targa,
XPM, Mac Paint, Ascii, Laser Jet, IFF/ILBM, Windows BMP,
Mac PICT, VIS, FITS, FACE, PCX, GEM/IMG, IRIS, YUV, RAW RGB,
Postscript, RAW GREY.
Preview: GIF, Jpeg, Windows BMP, PBM, PGM, PPM, Targa, PCX, Mac Paint,
Photo-CD.
All Read/Write formats support full color(8 bits), grey scale, b/w dither,
and 24 bits image, if allowed for that format.
(6) Overview:
Initialization steps:
Set default display type to highest display type.
Find an allowed screen resolution (for .grn video drivers only).
Read the configuration file (Global and Local).
Global: where DISPLAY.EXE resides. Local: Where you are.
Process the command line options (if any).
This Program is MEMORY-GREEDY. If you do not have enough memory, its
performance is poor.
(7) Detail: (written by Oliver Weyand, chbrin3@nyx.uni-konstanz.de)
GENERAL RULES
This section will describe the menus and options you can choose from. You can
read through it or just start the program and play around. When you have
a problem you can come back and read the section you need.
Most things are self-explanatory. Look for the comments behind a possible
command. Also keep an eye at the first and last row of the screen: DISPLAY
will tell you in most cases what is going on.
There are several fields with a special meaning (i.e. [ Auto Read ]). You
can activate them by moving the cursor inside the marks and then click the
left mouse button.
In any MENU you can call a pull-down-menu by pressing the F9 key or moving
the cursor to the top-line and click a button.
The different functions can also be selected by using a hot-key.
Sometimes DISPLAY will ask you questions. You can answer them with a mouse
click or by pressing the first (capital) letter of the answers
(Y or y for yes).
Allowed operations are shown in white the others in grey (if you use the
default colors).
-----------------------------------------------------------------------------
THE READ-MENU
-----------------------------------------------------------------------------
After starting DISPLAY, you will find yourself in the read-menu. You will see
a file list of the directory you started DISPLAY from (or the directory you
have specified with the -t command line option). There are six marked fields
you can use with the mouse. In the pull-down-menu bar you will find 8 headers
with a different number of options. Because all operations are accessible
with short-cuts, that's the easiest way to call them. For some operations
(e.g. slide show) you have to tag at least one file.
For Reading a file (image, movie) simply select one and press RETURN or double
click with the left mouse button. Display will autodetect the correct format
by itself. If you have problems try using the SPACE-bar or double click with
the right mouse button for selecting a format manually.
1. HELP
Calling help will load the READ.ME file. It contains help about possible
actions and a list of all short-cuts. There is also a description of the
meaning of the mouse buttons (be sure to check them out, because they
change, depending on the menu you use).
2. FILES
You have several options to manipulate files. You can delete, move, copy,
rename and view files. The options for shelling to DOS and quiting the
program are also located under this header. You can perform the actions on
a single file, a group of files, or the file currently under the marker.
3. DIR
From inside DISPLAY you can make directories. Another point is rereading
the current directory, for updating changes you have written to disk.
4. OPERATION
That's the menu with the real highlights of DISPLAY. Here you can choose
from the options: slide show, batch conversion, contact sheet, accumulate
quantization, and the special effects. Further you can display the fonts
comming with DISPLAY, show and write a already loaded image, and unpack
gl-files.
5. CHANGE
Under this header you will find options to select the image type and
graphic resolution (for a list of possible modes for your graphic card
take a look at the status menu or type L). Other options are for changing
the working-drive and for editing the file mask (see match.doc).
6. TAG
Believe it or not this one is for tag and untag files (single, group, all).
I think that's all you must know.
7. OPTIONS
This menu point is for changing the defaults. Open the submenu and you
will see a number of fields, where you can change most parameters that
DISPLAY uses. You can activate them just for one run or make them the
default by saving a new config.dis. You can work with different configur
-ations, when you use different local config.dis files (i.e. make
directories for the users of your system, if there is more then one).
8. STATUS
Here you can get informations about your graphic card, RAM, disk space,
and the formats of your image files.
-----------------------------------------------------------------------------
THE WRITE-MENU
-----------------------------------------------------------------------------
When you choose an option that will write changes to your disk, you will
sometimes enter the write-menu (i.e. moving files). In the write menu you
will find other marked fields for use with mouse. Although you will see the
same headers in the pop-up-menu, most of the options are disabled. Also the
most short-cuts won't help you. I think you will use this menu without
problems, because it is very self-explanatory.
-----------------------------------------------------------------------------
THE SCREEN-MENU
-----------------------------------------------------------------------------
Once you have loaded a picture, you will see the screen-menu (if you don't
set the 'auto_display_image' to 1). It has a different look and pop-up-menu
structure. If the loaded file is a movie, you will find yourself in another
menu, which is optimized for the additional needed options you need to
display movies.
The marked fields in the screen-menu are for viewing an image in the selected
resolution or writing it to file. Further you can go back to the read-menu or
exit the program. On the left you see three bigger fields. They are for those
of you, who are using a mouse and don't want to use the keyboard for pressing
the return, space, or esc keys.
The graphic modes you can select from (to show the image) are in white, the
others are grey.
Pressing F9 again will bring up the headers of the pop-up-menu. These have
changed a little, compared to the read/write menu
1. HELP
Same as in read/write menu.
2. FILES
Only the exit option is still there, for the other things you have to go
back to the read/write menu.
3. OPERATION
Three options are now in the submenu. You can choose between special
effects, display fonts, and change processing target. The last option
means to change between palette images (most 8-bit images are of that
type) and RGB-pictures (truecolor, highcolor). You can link these to
types, so that changes made to one type will also become true for the
other (see the file config.dis).
4. OPTIONS
Same as in read/write menu except for the preview option.
5. STATUS
The possible graphic and text mode are shown here (depends on your
hardware and the driver you use).
6. UTIL
This one is new in screen-menu. What you find in this submenu are some
often used operations from the special effects menu (look there for a
description of the comands).
-----------------------------------------------------------------------------
SPECIAL-EFFECTS-MENU
-----------------------------------------------------------------------------
When you start manipulating your pictures you will at some point look in the
special-effects-menu. The different effects are sorted in 6 groups. As
mentioned above you can rotate, flip, resize, mix, and convert images.
Most often other programs offer only a few operations DISPLAY is able to do.
Some other effects DISPLAY performs are otherwise found in professional and
expensive graphic packages only!
In this chapter you will find the complete list of possible effects with some
short comments. The numbers are the same as in DISPLAY. If you want to make
some of these effects the defaults for batch conversion please find the
[Batch_Convert] section in config.dis and read the comment.
Number Operation Comment (if necessary)
(01)-(01) Flip Horizontal -
(01)-(02) Flip Vertical -
(01)-(03) Rotate Clockwise (90) -
(01)-(04) Rotate Counter-clockwise (90) -
(01)-(05) Rotate/Shear image (any angle) lets you rotate the image any
angle you want. If you don't
know what shearing means just
do it. It's easier to look
than to explain.
(02)-(01) Resize image ( ->24 ) the resizing operation will
promote the image to 24-bit
if you smooth it. In the
upcoming screen are some more
options: You can change the
size by pixel, by %, or
resize different images to
the same size (batch conver-
sion)
(02)-(02) Auto Crop cuts off "unused" pixel. Better
use the online crobbing in
graphic mode (Crtl-cursor).
Useful for batch conversion
(02)-(03) Mix/Concat two images overlay or put together two
images with different options
(02)-(04) New Dimension Adjust the image dimension.
Adding background or cropping
if necessary.
(03)-(01) Convert to Grayscale -
(03)-(02) Do B/W Dither -
(03)-(03) Pseudo Color do you like strange effects ?
(03)-(04) Color Quantization try FS (Floyd-Steinberg) first
(03)-(05) Promote to 24-bits -
(04)-(01) Histogram Equalize enhance the contrast.
(04)-(02) Smooth/Enhance Images -
(04)-(03) Edge Enhancement opposite of smoothing
(04)-(04) Negate Image -
(04)-(05) Oil paint ever wanted to be a painter ?
(04)-(06) Gamma Correction better use F1-F8 in graphic
mode. Useful for batch convert
(04)-(07) Cheesy Embossing convert color to height-field
(04)-(08) Remove unused colors -
(04)-(09) Swap R/G/B make some funny images !
(05)-(01) Discard 24-bit image -
(05)-(02) Discard 8-bit image -
(05)-(03) Push image into stack -
(05)-(04) Pop image from stack -
(05)-(05) Clear stack -
(06)-(01) Load Palette Table -
(06)-(02) Save Palette Table -
(06)-(03) Display Palette Table -
(06)-(04) Push Palette Table -
(06)-(05) Pop Palette Table -
(8) Tech. information:
Program (user interface and some subroutines) written by Jih-Shin Ho.
Some subroutines are borrowed from XV (2.21) and PBMPLUS (Dec. 1991).
JPEG is based on the library by the Independent JPEG Group.
Tiff (V3.2) reading/writing are from the Tiff library (from ftp.sgi.com).
DL is based on xdl.c & Xanim260.
FLI/FLC is based on the article in DDJ (Mar. 1993).
MPEG is based on Berkeley mpeg_play 2.0.
AVI is based on Xanim260 by Mark Podlipec.
MPEG split is based on mpgsplit by Stefan Eckart.
Compiled with DJGPP.
You can get the whole DJGPP package from :
omnigate.clarkson.edu: /pub/msdos/djgpp
(9) For those who want to modify a video driver:
1. For HiColor and TrueColor, please refer to ET4000.ASM.
(10) Final:
This document is not well written. If you have any PROBLEMS, SUGGESTIONS,
COMMENTS on this program, please send a mail to
u7711501@bicmos.ee.nctu.edu.tw (140.113.11.13).
(There is NO anonymous ftp on this site.)
I need your suggestions to improve this program.
Acknowledgments:
I should like to thank the authors of XV and PBMPLUS for their permission
to let me use their subroutines.
Also, I thank the authors of the TIFF and JPEG libraries.
Thank you DJ. Without DJGPP I can't do anything on a PC.
The author would like to thank Olivier Dumas, Ben Jos Walbeehm,
Bryan Woodworth and other users for their advice and suggestions.
The author would like to thank NCTUCCCA for offering a place for DISP.
Jih-Shin Ho
u7711501@bicmos.ee.nctu.edu.tw